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el 


PRE FA CE 


This software docuaent 7s a supplement to the 8.2 
Software Release Desc ription (SRD) of the Sperry Univaec 
Operating System O0S/2. 


The OS/3 Release 8.2 ANSI'74 COBOL non-English text utility 
is provided for System 80 Model 8 users. This document 
contains information not intended for general distribution. 


This product should be ordered using the Software System 
Request form (UD1-1423 ). 
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1. Introduction 


The Non—Enolish Text Utility is used in conjunction with the ANSI “74 
COROL Compiler to produce Listings in languages other than Englishe The 
utility is used te provide translated diagnostic messages and Listing 
neaders to the COSOL compiler. khen compiling his proyram the user nay 


specify the language in which his messages and headers are to be 
printed. 


The utility is comprised of two programs, the Data Generator (DATGEN) 
and the Wodule Generator (CMODGEN). The Data Generator reads in 
translLatec messages as transactions and builds a master fite containing 
the translated smessagese The master file for English messages is 
supplied with the Text utility mocules. The master file is used as 
jnput to the Module Generator. This program builds two assembler 


These 


Language source modules which contain the translated information. 
modules will be assembled and provided to the compiler. 
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2- tata Senerator 


The lata Generator reads the translated messages. and provices a file 
containing the New meSSagese The program reads the transactions ano 
compsres them to the supplied saaster file containing English sessage se 
If a translation is provided, it ts placed in the output file; if net, 
the English version is usede The Data Generator can also pe used to 
update existing saster files and provide listings. If a (non-English) 
master file its used as input along with the transactions, an updated 
version of the (non-English) saster file will be produced. If no 
transactions are input, the aaster file output will be butlt frog the 
master file input (English is the default) and a listing of the fite 
wilt be producede The master files are SAM type with. variable length 
Tecords in 2046 tyre blockse 


2et Transaction Fite 


The transaction file contains translations of CGEOL messages. The. 


transaction can only apply to an existing messase, new ones cant be 
added. There are four types of messages which say be translated; 
diagnostics: coded symbols: headers and commentse 


2etet Message Types 


The ciagnostics are the error messages generated by the compiler. These 
messages may constst of a nusber of words, including inserts, The 
inserts indicate where in the message additionat data (if any) is to be 
olacede Each word can have up to 103 characters. 


Coded symbols are character strings which are inserted in the COBOL 
diagnostics. One diagnostic message may be applicable to 2 number of 
concitions and these conditions may be indicated by separate symbols. A 
codec Symbol may be a COSZ0L reserved worde in which case it should not 
be transtatec. The listing indicates whether a symbol is reserved or 
not, and in which messages and inserts the symbol may appeare A coded 
symocl consists of one word of no more than 102 characters. 


The headings used in the compiler Listings are the header messagese A 
header consists of a series of words and inserts shich identify the 
various compiler tistings and the data printed thereon. The worcs in 
some headings must appear in particular positions of the Line (Cecege 
column headings); these are positicnal headers-e The pata Generator will 
automatically align words in headers of this typee The totat Length of 
the header should not exceed 123 characterse The Listing of the master 
file will contsin the header types length and short description of 
inserts, and the length of all words in positional headers. 


The last tyre of message is comments. These mesSageS are usec to 
provide additional descriptico anc commentary on output Lines. 4 
comment consists of one word of no more than 120 cheracters. 
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2etTew2 Transaction Format 


Each Line of the transaction file contains the translation of a message. 
The first word of the transaction is a Single letter which foentifies 
the type of the message: A for diagnostics, & for coded symbols, C for 
heacers anc’ D for comments. This is followed by the identifying number 
for the messagee This number accompanies the message on the Listing anc 


jt has at most 5 digits, leading zeros mot required. The word(s) of the 
translation complete the trans acticne 7 


Each word of the transaction must be separated from the other words by 
at least one space. The punctuation characters Ccolons semicotony, 
comma, anc period) need not be preceded' by a space but must be folloxed 
By onee Inserts are indicated by suffixing a number to the characters 
“INS”. The English message inserts are numbered from left to right but 
the order of appearance of the inserts say be changed by siaply putting 
the insert indicator in its new positione 


Two special characters are all aed in the transactions; the continuation 
(7-") and the connector (78%. If a transaction needs more than ane 
line, a continuation should appear in column 1 of sll succeeding tines. 
This will append alt characters of the continued tine to the Last 
non=btlank character of the preceding line. note that a space is 
required in column 2 if the last word on the preceding line is ended on 
that Line Ciee.e not continued J. The connector allows two or more words 
to be joined into onmee Although this symbol is always treated as part 
of the word, it will be changed to a space before it is printed. This 
symbol is useful for. putting multiple words in a coded sympol or 
comment, and for adding spaces between words in heacingse : 












































L A 97002 TOO MANY WORDS FOR 
l= ONE LINE. 


TCO MANY WORDS FOR ONE LINEo 


fxamples 
I TRANSACTION I NEW MESSAGE i 
1 Type Number Translation i Result } 
t A 0501 THIS IS TRANSLATE De f THIS IS TRANSLATED. I 
fA &03 TRANSLATION EXAMPLE TRANSLATION EXAMPLE i 
] A 5S CONTAINS INS? INSERT. CONTAINS *insert® INSERT. i 
{ & ascos USESDOF ACONNECTOR USE OF CONNECTOR j 
}C 11901 THE INS2 INSERT IS INST. THE *ins—2% INSERT IS sins-t*. i 
Ic 15007 DOUBLES SPACES WORDS SDOUBLE SPACE WORDS 4 
1 
b 
i 
i 


t 
H 
{ 
| 
j 
dD C7001 CONTIN : CONTINUED 
h 
i 
t-—- 





or ce 
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2-2 Samele Translation 
To perform the translation, a Listing of the messages to be translateca & 


is required. Below is a sample set of messages to be translatede It 
contains 2 diacnestics, 1 coded sygbol, 2 headers and 2 comments. 








| -------4--------- —--—- -- —- — —— -- -- 








eee aes | 















































| nom | Message i 
|---—--+}-------------—- = nr | 
| 1 | woRD TOO LONG. i 
} 5 | TRUNCATION OCCURS ON wx insert-1*. i 
1 95 | THE *ins-1* PICTURE *ins-2* IS INCOMPLETE. : i 
[eee ferme === en me | 
1 03002 [| FRACTIONAL i 
Jowoonne fe a a aw fae ae aa ——— ———| 
1 12CO1 | PROGRAM=IDs t#ins—1* DIAGNOSTIC MESSAGE PAGE *ins-z*| 
| 12002 [| LINE LVL ERROR DI AGNOSTIC MESSAGE ‘| 
[----—-— t--- Se ee a eee --- | 
1 14035 | *** ADDPESSES OF PEP TABLES *#**% i 
f 14038 | COLLATING SEQ TABLE i 


|-------+——-- 

















| 


To translate these messages into another Language Ceqe Pig Latin, a 
transaction file must .be built containing the translationse Each 
transaction begins with a code letter for the type of sessage; A tor 
diagnostics, 8 for coded syabots, ct for headers and dD for comments. 
This is followed by the message number and the translation.e The 
. translation has indicators for inserts and allows changes in the wors 
order if desired. If a translation is too Long for one record it may be 
continued onto successive cards by using the continuation character (-). 
The connector symbot (€a) is used to introduce spaces into the 
translatione Note its use in 12001 to center the words “DIAGNOSTIC 
LISTING”. Message 12202 is a positional header, jee one where the 
position of the words is important (as in column headers). The utility 
will place each word in its correct position, and if more than one word 
#s required at one position it can be made with the connector symbole 
Note that in the two comments: since more than one word is desired in a 
coded symbol or comment, the connector is again used to connect aultiple 
wordse The following is a possible transaction fite fer Pig Latin. 








aa Gee en ——— | 
JA 1 GRBWAY ONTAINSCAY OOTAY ANYMAY ARACTERSCHAY. t 
{A OS UNCATIONTRAY OCCURSAY ONAY INS1. ‘| 
l 
1 
\ 
i 
i 














1 A 95 IKS2 ISAY INCOMPLETEAY INS4 ICTUREPAY. 

18 O7002 ACTIONALFRAY 

} € 12001 OGRAP—IDPAY: INS1 as 3S IAGNOSTICDAY ISTINGLAY 
I- SEdSSAGEPAY INS2 

1 ¢ 126092 LINE LVL ERRORAY I ASNC STICDAYSESSAGEMAY 

{Oo 14025 *teeacODR ESSESAYQOF AY GEPP AYEAELESTAY30 «%x 

[D0 14538 OLLATINGCAYSEQSAYSASLETAY 


i 
i 





SS PS ES EE OE ee ee ee ry 








FEBRUARY 1984 NON@ENGLISH TEXT UTILITY 5 


ee eh DTA A CIR ALE RL AE ALTE TE TL LE EE IIE 





2.3 Interface 


The listing procuced by the Data Generator provices information on the 
messages contained in the master file. For ciagnostic messages this is 
the number, severity and text cf the diagcnostice 3estdes the number anc 
text of the codec symbol, the usage, in message and insert numbers, anc 
an indication for reserved word (RJ or not (nd) are provided. The 
information for headers ineludes number, type (positional is P, 
otherwise WN), Length of inserts, short descriptions of inserts, tength 
of each word for positional headers, and the text of the heading. The 
comment data has the number, maximus length and text for the comment. 


Three files are used for input anc output to the Data Generator; the 
master file output (MASTOUT), the master file input (MASTIN), and the 
transaction file (TRANS). The use of these files is indicated by the 
Parameters. These parameters are set by the PARAM statement with the 
form: // PARAM parms a - 
The parameters are: ; 

MAS TOUT=YES (non-English) master output file produced (de fault) 

NO file not produced 


PASTIN=YES Cnon-Englishd) master input file provided 
NO file not provided (default) 


TRANS=YES transaction file provided 
NO file not provided (default) 
fe SYSTEM control stredm 
Cmodname) module mocname on transaction Library file 


The cise files to be used will have lLinknames of MASTOUT for the master 
output file, FASTIN for the Cnon—English) master input fite and TRANS 
for the transaction file. 
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3. xedule €enerator 


The rodule Generetor reads the raster file and produces assembler source. 
files for the languagee There are twe source files for every language. 
The ciagnostics and coded symbols ere in ome module and the headers ana 
comments ore in the other. The Fodule Generator places the assembler 
source in files the user specifies and provides listings of the source. 
The input to the Module Generator is a master file produced by the Data 
Generator. This file contains the description of the sessages- The 
Module Generator formats the information in a form the compiler can 
process and builds two asseabler source programs containing the 
informatione 


Ine source contains the diagnostics and coded symbols anc is used when 
the error messages are printed. The other source contains Listing 
headers and comments and is used whenever a listing is produced. The 
two sources are placed in separate files and listings of them are 
oroaqucede 


There are two parameters used by the Module Generator. They are 
specified by using the PARAM statement with the form: // PARAM’ parms 


The parameters are: siete oe 


Se eee (8 characters or less) default: English 


file-name , Ge fauit: COBLLANG 





Tyo source modules will be placed in the library file named, with module 


et ee ya the language name suffixed with 'M' for diagnostic 
ages an or headers. Th i i i 
ee ee e€ master input file must exist and have 
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f 


4. Compiler Interface 


Tne ANSI “74 CCO5OL compiler sill use the information contained in the 
message mocules to present its output in the different Languagese The 
two source rmocules provided by-the utility will be assembled and made 
avaitable to the compiler. To specify the Language to be used, the 
MESSAGES clause in the ALPHABET section of the CONTROL division is used. 
The language specified in the FESS AGES clause should be the same as that 
specified to the Medule Generator. The correct language modules wilt be 
selected from those available to the compiler and used for the Listings. 


The two modules provided by the utility should each be assembled. The 
two cbject modules thus obtained will be Linked into two separate load 
mocules which are placed in the system load library. when a xodule is 
needed by the compiler, a LOAD is pertcrmed. 
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5. Summary 


The non-English Text Utility its made up of two programs, the Data @ 
Generator and the “Yodule Generators which are summarized below. 


5e1 sata Generator 


Inputs 
Master input files linkname MASTIN 
Transactions: if disc file, Linkname TRANS; else on systes 
input strear 


Cutputs 
Master output files Ll inkname MAS TOUT 
Master file Listing 


Farameters 
CYASTOUT={YESINO}I] Cy MAST IN=CYES [NO}3 
CyTRANS=C YES INOJ SYSTE wl (Cm cdname)}3 
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Figure 1 
DATGEN INPUTS 
+ SPOOLIN + - —= + 
I - - | / a | 
J a I | Card Reader | 
1 I I { 
+ Disc File + +e eee eet 
$ + ewe + 4 
= + + = 
ftw wee wee + GETCS ee ee ee eee 2 
+.) 
+ 
Se s—-—Coptional via TRANS= 
+ SAM + : 
ics | zs: sn\ 
H oo I 2 lol 
H 1 : Ipl 
* Disc File + $e re ie met itl 
= - | | Lil 
<< 1 | lo] 
: I DATG EN l-—-I nl] 
: { IN PU TS I lal 
: I t bul 
: I 1 in| 
+= a + ee ee ee eee eee cree} ivi 
+ + = bil 
+ SAMIO + 4 lal 
+ + : {{ 
tmnt : is] 
s (LFD = MSTABLE) : tAl 
< (LEL = COBLERRS) . ts! 
.——---—— —-————=: iti 
tr] 
int 
1=| 
\=/ 


























— 


+ rt 
+ + 
+ SAMIO + 
+ + 
+~ + 

CTRANS) 

+ SAM + 
lL - - | 
loo s--- | 
i I 
+ + 


$= 








eo se 











xan 


+ SAMIO + 


Dee ren 


CMASTINI 
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Figure z 
DATGEN OUTPUTS 
ene ee + | 
1 i | 
{ 
: —| DATE EN 1 s-\ 
2 t OUTPUTS i lol 
2(CPRNTR) { [| Ipl ——=s 
: I ft itt : 
Fs t— Sf i | : 
(acme eaeee tees : iol +. am 
+ + : Inl + + 
+ SAPIO + 2 lal + SAMIG + 
+ + : [tl + + 
ieee pesnees : in| tat 
: = ivl < 
: -o-—— Lil 4 
: (AS TOUT) fal : 
7 : | 1 : 
men een + ml ee 
I I Lal - - 
I LISTING | Isl + SAR + 
I ——<—+ iv! I - - | 
| Seay lo] I = I 
+———/ [ul | i 
{Tl + + 
t=) 
\-/ 
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Se2 “adule Generator 


Inputs 
Master input file: linkname MAST 


Sutputs 
Two modules in one library file ime 


Listings of the two sodules 


Parameters 
CFILE=filenase] (C,NA¥ E=La nguage-naze J 
cefautt FILE is COBLLANG a 
default NAME is ENGLISH 





FEBRUARY 1984 NONENGLISH TEXT UTILITY le 





MODGEN INPUTS AND OUTPUTS 





Ficure 3 
I - - ] + + 
I = | -——-----—- + SAm xo + 
I I + + 
+ Dise File + 7 $ oe ee + 
—<— 2 (haST) 
: | 
\c/ 
ee es eee eres ae er eee amend 
MODG EN 




















\:/ \e/ 
+ + + + 
+ SAMIO +#¢ + SAMIO +¢ 
5 eee + + + 
+ ——+ + —s 
= SERINE? sCLFD FILE=naee) 
: sCLEL anyname) 
bees oS ai. 
{ 2 oer 
! LISTING | + SAM + 
---+ | - -1 
J -—-/ I ! 
+-——/ ! H 
+ Dise File + 
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Se Sample Job Stream 


The following show different uses of the utility with the corresponding 
job stream. 


// JO9E UPDATE, ,CO0) 


4/4 ove 20 // LED PRNTR : : 
‘4 DVC SO ¢/ VOL vol // LBL UPDATES // LFD TRANS 3 
4/7 pve 51 S7 VOL volt // Lea ERRORS // LED MASTIN 4 

: ff ONG SC // VOL vol J// L5L ERROUT // LED MASTOUT 5 

i 4/4 OVC RES // LBL COBLERRS // LFD MSTABLE 6 

: J/TRNERR WORK1 yf 
‘/ EXEC DATGEN é 
/1 PARA4 MASTIN=YES sTRANS= (pod name) 9 
‘4 OVC 50 // VOL vot // L3L ERROUT // LED MAST 10 
4/4 OVC 51 // VOL wott s/ LBL ERRASH // LFbD CBFRENCH 41 
/‘/ EXEC MODGEN : 42 
: PARAM NAME=FRENC Hy FILE=C3 FRENCH 13 
‘/ FIN 


le Specify JOB card. Note that 48K must be available, 
2 Ze Specify printer device. 

@ Ze Specify library file that contains transactions. 
4- Specity master file to be uwda ted. 
Se Specify output master file. 
6- Specify message mastere This must always be specified. 
7e Specify work file. This must be done if any transactions are conee 
8- Execute the Data Generator. 
9 Specify master file used and transaction module. 
10. Assign LFD name for master file. 
11-2 Specify output file for Language modulese 
126 Execute Module Generator. 
13- Specify Language as French and output file tFp. Modules FRENCK ana 
FRENCH witl be built. 


// SOE LISTENG ,,&C90 1 
4/ DVC 20 // LFD PRNTR 2 
// CVC RES // LBL COBLERRS // LFD MSTABLE 3 
Jf EXEC DATGEN 4 
4/4 PARAM MASTOUT=NO 5 
4% 

// FIN 


1. Specify JOE cards Note that 32K must be available. 
2e Specify erinter device. 
3. Specify message master. 
Ge Frecute the Data Generator. 
@ Se Set to get output Listing only. 


e 
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7?.e Crror Kessages 





If an error is encountered during processing of the translations, a & 
message iS printed. The following table tists the 11 errors and 2 
warnines which may be printede ‘Severity 2 indicates the transaction 
will ve celetec, severity i indicates the transaction will be appliec 

with errors and 2 simple warning its severity Oe 
























































































































































—-! 

1 [CODED SYMBOL OR COMMENT HAS [Coded symbols and comments canj 
{[>4 wOFD Jonly have one word. See connector! 
] Isymbol for multiple words. 


---4-+------------ —-—-----— —~—} 


[---+-----------—- _—--—- —- -- f--—--- = | 
ISevl wessage H Cause j 
|---+-------——----—- woe foe ee Se —-j| 
J 2 [ILLEGAL ID CATEGORY {An ID other than A, B, C, or D wasi 
I | lencounterede i 
| -——4f-— ————-—--—- too - —_— a= | 
[| 2 [ILLEGAL MESSAGE NUMBER TA non-nuseric message number or ai 
ee | Inumber with too many  characters| 
I l [was encountered i 
| ea pe nn nn nnn ot eee —---——-——— | 
] 2 INON—EXISTANT ME SS AGE Is {The message number does not{ 
! {TRANSLATED lcorrespond to any known sessage.| 
|---+----—-----------— —-———F _-——— —_— ——— | 
I 2 [MESSAGE CONTAINS WRONG NUMBER [The number of inserts in thej 
| JOF INSERTS Itranslation does not correspond tol 
| | Ithe actual number of inserts inl ; 
| | {the message ae | 
j--- ——— - ———— + rea | 
1} 1 [DIAGNOSTIC WORD OVER 103 [The word Ys too Long and isi | 
= fo * TOHARACTERS Itruncated. | 
| am en a nn ne eee Se aan a= | | 
1 1 JcOpeD SYS OL OVER 103 [The coded symbol is too tong andl 
| [CHARACTERS lis truncated. I 
J -——t--- Sree eer ee ae —_— — a ae | 
[ 1 JPOSITIONAL HEADER WORD TOOJA word in a positional header is} 
pins Itoo tong and is truncated. | 
——_ > RPS COPA: ide Oe SS cme ene cane —-} 
1 1 $COMMENT CONTAINS TOO MANY IThe comment exceeds the saxiaun! 
{ [CHARACTERS Isize alloved. - j 
[oo- fe ———<— — ———— —-/ 
1 4 [CHARACTER STRING EXCEEDS 120 [The character string is too longei 
1 JCHARACTERS { | 
[---+}+------------ Sf ———-- —| 
1 1 IMESSAGE TEXT NOT FOUND Ino transtation is provided for the} 
| jmessagee | 
I 
I 
! 
j 
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| ---+-—----------- 


ISevl Wessage l Cause fj 


| ---}-----------—— —--— 


} 7 TRESERVED wOFD SYMSOL aASTA coded symool comprised of} 

















——— }—--- —-| 


























I [TRANSLATED lreserved word(s) was translated.: 
|---t--- —-——— ——-— —— + - - — i 
[ 0 JWARNING: nnn MESSAGES NOTIWhen a translatlTion of the sasteri 
I ITRANSLATED Itile is being done (not ank 
! | Jupdate)s the ~~ number of | 
| | Inon-translated messages isl 
i I lprinted. l 
f--—-t-—— we ee eee - —-|} 





Be Erglish Listing 


The default language used is English. The Data Generator CDATGEN) 
should be used to obtain fornatted printed Listings of the master file 
for the English Language. 


— ‘oe ‘dies 


Je MASTER FILE CENGLISH) 


The master file used by the Data Generator is supplied with the Text 
Utility prograese This file aust be used by the pata Generator programe 
The master file is supplied with the Text Utility possibly on tape Cas a 
SAm filed, The tape file must pe converted to a SAM DISK file to be 
usec by the Cata Generator program. The following show a sample use of 


SS/3 DATA UTILITIES to put the tape file onto a DISK in a form usable by 
the Cata Generator. 


‘ft 3CB LOADITs,8000 

4‘/ pNC 20 // LED PRNTR 

7/ OVC 94 // VOL SO4095 // LFD INPUT1 
// pVC RES // EXT S$Q,C,0,CYL,5 

// LEL COBLERRS // LFD OUTPUT gg INIT 
// EXEC DATA 

ts 

UTD A= (204452045) _ FVeLD yg IROR 

Ix 

43% 

ft FIN 


“ 











